home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 2 / AACD 2.iso / AACD / Magazine / GraphicsCards / StormMesa / README.GGI < prev    next >
Text File  |  1998-12-15  |  4KB  |  173 lines
  1.                        LibGGI driver for Mesa-3.0
  2.           by Uwe Maurer (uwe_maurer@t-online.de)    
  3.  
  4.  
  5. Introduction
  6. ============
  7. [from libggi.txt by Steve Cheng and Hartmut Niemann]
  8.  
  9.  "LibGGI, the dynamic GGI (General Graphics Interface) library is a
  10.   flexible drawing library.
  11.  
  12.   It provides an opaque interface to the display's acceleration
  13.   functions. It was originally intended to allow user programs to
  14.   interface with KGI, the kernel side of the GGI code, but other display
  15.   types can be easily used by loading the appropriate "display target"
  16.   (e.g. X, memory).
  17.  
  18.   LibGGI consists of a main library (libggi.so) and a multitude of
  19.   dynamic drivers. The library then loads the necessary "drivers" for
  20.   the requested mode, taking hints from the graphics device if
  21.   necessary. LibGGI can also load extension libraries, e.g. to provide
  22.   enhanced 2D and 3D functions.
  23.  
  24.   It has been designed after having a look at several existing
  25.   libraries, and so far we have found porting to be quite simple from
  26.   and to most of them."
  27.  
  28. ----------------------------------------------------------------------------
  29.  
  30.     More information about the GGI project and LibGGI can be 
  31.     obtained from the GGI website:
  32.  
  33.     www.ggi-project.org
  34.  
  35. ----------------------------------------------------------------------------
  36.  
  37. Installation
  38. ============
  39.  
  40.     - Install LibGGI
  41.     
  42.     - Unpack the Mesa archives
  43.     
  44.     - In the Mesa directory type:
  45.         
  46.         make linux-ggi
  47.         su
  48.         make linux-ggi-install
  49.         exit
  50.     
  51.     - Now you can try some demos.
  52.       If they don't work, you can set the GGIMESA_DEBUG
  53.       variable to 255 and you will see some information from the
  54.       LibGGI-driver.
  55.          
  56.        export GGIMESA_DEBUG=255
  57.     
  58.  
  59. GLUT
  60. ====    
  61.  
  62.     You can change these default values in ggi/ggiglut.c:
  63.     #define WIDTH   640
  64.     #define HEIGHT  400
  65.     #define GRAPHTYPE_RGB   GT_16BIT
  66.     #define GRAPHTYPE_INDEX GT_8BIT
  67.  
  68.     Options:
  69.         -bpp x        Set graphic mode with x bits per pixel    
  70.         -size x y    Screen (or window) is x*y pixels 
  71.  
  72.     Example:
  73.         demos/gears -size 320 200 -bpp 24
  74.  
  75. Updates
  76. =======
  77.     
  78.     You can find the latest LibGGI-driver and ggiglut on my
  79.     homepage:
  80.     
  81.     http://home.t-online.de/home/uwe_maurer/ggimesa.htm
  82.     
  83.         
  84.  
  85. Uwe Maurer  -  uwe_maurer@t-online.de
  86.  
  87.                        LibGGI driver for Mesa-3.0
  88.           by Uwe Maurer (uwe_maurer@t-online.de)    
  89.  
  90.  
  91. Introduction
  92. ============
  93. [from libggi.txt by Steve Cheng and Hartmut Niemann]
  94.  
  95.  "LibGGI, the dynamic GGI (General Graphics Interface) library is a
  96.   flexible drawing library.
  97.  
  98.   It provides an opaque interface to the display's acceleration
  99.   functions. It was originally intended to allow user programs to
  100.   interface with KGI, the kernel side of the GGI code, but other display
  101.   types can be easily used by loading the appropriate "display target"
  102.   (e.g. X, memory).
  103.  
  104.   LibGGI consists of a main library (libggi.so) and a multitude of
  105.   dynamic drivers. The library then loads the necessary "drivers" for
  106.   the requested mode, taking hints from the graphics device if
  107.   necessary. LibGGI can also load extension libraries, e.g. to provide
  108.   enhanced 2D and 3D functions.
  109.  
  110.   It has been designed after having a look at several existing
  111.   libraries, and so far we have found porting to be quite simple from
  112.   and to most of them."
  113.  
  114. ----------------------------------------------------------------------------
  115.  
  116.     More information about the GGI project and LibGGI can be 
  117.     obtained from the GGI website:
  118.  
  119.     www.ggi-project.org
  120.  
  121. ----------------------------------------------------------------------------
  122.  
  123. Installation
  124. ============
  125.  
  126.     - Install LibGGI
  127.     
  128.     - Unpack the Mesa archives
  129.     
  130.     - In the Mesa directory type:
  131.         
  132.         make linux-ggi
  133.         su
  134.         make linux-ggi-install
  135.         exit
  136.     
  137.     - Now you can try some demos.
  138.       If they don't work, you can set the GGIMESA_DEBUG
  139.       variable to 255 and you will see some information from the
  140.       LibGGI-driver.
  141.          
  142.        export GGIMESA_DEBUG=255
  143.     
  144.  
  145. GLUT
  146. ====    
  147.  
  148.     You can change these default values in ggi/ggiglut.c:
  149.     #define WIDTH   640
  150.     #define HEIGHT  400
  151.     #define GRAPHTYPE_RGB   GT_16BIT
  152.     #define GRAPHTYPE_INDEX GT_8BIT
  153.  
  154.     Options:
  155.         -bpp x        Set graphic mode with x bits per pixel    
  156.         -size x y    Screen (or window) is x*y pixels 
  157.  
  158.     Example:
  159.         demos/gears -size 320 200 -bpp 24
  160.  
  161. Updates
  162. =======
  163.     
  164.     You can find the latest LibGGI-driver and ggiglut on my
  165.     homepage:
  166.     
  167.     http://home.t-online.de/home/uwe_maurer/ggimesa.htm
  168.     
  169.         
  170.  
  171. Uwe Maurer  -  uwe_maurer@t-online.de
  172.  
  173.